The Reflection API 



Page 1 of 2 



The Java™ Tutorial 



Start of Tutorial 



Search 
Feedback Form 



Trail: The Reflection API 

by Dale Green 



Your feedback is important to us! Please send your comments and suggestions to us Q.„ 
using the feedback page . 

The reflection API represents, or reflects, the classes, interfaces, and objects in the current Java i 
Virtual Machine. You'll want to use the reflection API if you are writing development tools such as 
debuggers, class browsers, and GUI builders. With the reflection API you can: 

• Determine the class of an object. 

• Get information about a class's modifiers, fields, methods, constructors, and superclasses. 

• Find out what constants and method declarations belong to an interface. 

• Create an instance of a class whose name is not known until runtime. 

• Get and set the value of an object's field, even if the field name is unknown to your program CO 
until runtime. 

• Invoke a method on an object, even if the method is not known until runtime. 

• Create a new array, whose size and component type are not known until runtime, and then 
modify the array's components. 

First, a note of caution. Don't use the reflection API when other tools more natural to the Java 
programming language would suffice. For example, if you are in the habit of using function pointers in 
another language, you might be tempted to use the Method objects of the reflection API in the same 
way. Resist the temptation! Your program will be easier to debug and maintain if you don't use 
Method objects. Instead, you should define an interface, and then implement it in the classes that 
perform the needed action. 

Other trails use the term "member variable" instead of "field." The two terms are synonymous. 
Because the Field class is part of the reflection API, this trail uses the term "field." 

This trail uses a task-oriented approach to the reflection API. Each lesson includes a set of related 
tasks, and every task is explained, step by step, with a sample program. The lessons are as follows: 

HI Examining Classes explains how to determine the class of an object, and how to get information 
about classes and interfaces. 

I|| Manipulating Objects shows you how to instantiate classes, get or set field values, and invoke 
methods. With the reflection API, you can perform these tasks even if the names of the classes, 
fields, and methods are unknown until runtime. 

|§§ Working with Arrays describes the APIs used to create and to modify arrays whose names are 
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describes the APIs used to create and to modify arrays whose names are 
not known until runtime. 

IM Summary of Classes lists the classes that comprise the reflection API, and provides links to the 
apppropriate API documentation. 



Start of Tutorial _ « Sea 1 " 0 * 1 
Feedback Form 



a 
O 
O 

LU 

I 

CO 
LU 
GD 



http://java.sun.com/docs^ooks/tutorial/reflect/index.html 



2/23/01 



